home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 3 / AGA Experience Volume 3 (1997)(NFA - SAdENESS)[!].iso / software / utilities / programmers / c_dt / readme
Encoding:
Text File  |  1997-01-03  |  5.7 KB  |  139 lines
  1.  
  2.   samplePNM.datatype and source-code V43.4 (3.1.97)
  3.   (C) 1996-97 by Andreas R. Kleinert. All rights reserved.
  4.  
  5.   ---
  6.   This small sample datatype source code demonstrates, how to completely
  7.   write an Amiga OS 3 datatype (V40/V43) without any assembler stubs
  8.   or compiler/linker tricks in PURE C source code (currently SAS/C-based:
  9.   see Aminet:dev/c/CLib37x.LHA on how to adjust for some other compilers).
  10.  
  11.   You may e.g. use this example source code to write more portable
  12.   Amiga OS 3 datatypes to allow easier porting of these
  13.   to other Amiga OS-derived operating systems, or the native
  14.   OS of an upcoming PowerPC Amiga.
  15.  
  16.   Translate your 68k-assembler datatype startup-codes smartly
  17.   to C by simply using this source-code as an advice how to do it.
  18.  
  19.  
  20.   As a common case, a datatype of class picture, supporting
  21.   PNM-PGM (P5) and PNM-PPM (P6) has been used as an example.
  22.  
  23.   With picture.datatype V40-42 only PGM is supported,
  24.   and with picture.datatype V43 reading of PPM is offered as well,
  25.   while encountering an PGM file under V43 causes a fallback to V40
  26.   routines (could have been done differently, but was not necessary
  27.   here just for demonstration).
  28.  
  29.   For testing this datatype, simply use a tool from the NetPBM package
  30.   (or maybe for example a tool supporting superview.library) and save
  31.   a graphics in the binary PGM or PPM format (P5/P6 of the PNM series).
  32.  
  33.   Then install this datatype and try loading the file via MultiView.
  34.   Should work fine.
  35.  
  36.   ---
  37.   Feel free to use this source for own projects.
  38.  
  39.   It is allowed to be spread and distributed anywhere, as far
  40.   as my consent is concerned.
  41.  
  42.   Amiga Technologies, or the current owner of the technologie,
  43.   is allowed to always put this source on their newest
  44.   Developer CD-ROM.
  45.  
  46.   Thanks and credits will always be appreciated - for example,
  47.   you MAY, but NEED NOT:
  48.   give me credits in your program's docs, send me keyfiles for
  49.   your programs using the library, and so on.
  50.   But that's simply voluntarily.
  51.  
  52.   This work was only roughly inspired by David Junod's original
  53.   example source codes for datatypes.
  54.  
  55.    _________________________________________________________
  56.   |      You may reach me the following way.                |
  57.   |    Send bug-reports, money or whatever to:              |
  58.   |---------------------------------------------------------|
  59.   |        * SuperView Development & Registration *         |
  60.   |          * DRAFU Development & Registration *           |
  61.   |       * Image Engineer Registration Site Europe *       |
  62.   |                                                         |
  63.   |                                                         |
  64.   |                  PerSuaSiVe SoftWorX                    |
  65.   |                                                         |
  66.   |                  Andreas R. Kleinert                    |
  67.   |                  Sandstrasse 1                          |
  68.   |                  D-57072 Siegen                         |
  69.   |                  Germany, Europe                        |
  70.   |                                                         |
  71.   | Any snail mail to the old address will still be routed. |
  72.   |                                                         |
  73.   |                  Phone:  +49-271-22869 also FAX + AM    |
  74.   |                          +49-271-22838                  |
  75.   |                                                         |
  76.   |                  Weekdays after 17.00h.                 |
  77.   |                                                         |
  78.   |         When calling via phone you may leave a message, |
  79.   |         if I'm not available - but don't expect me      |
  80.   |         calling back to USA, Australia, ... since       |
  81.   |         german phone rates are HIGHLY expensive.        |
  82.   |_________________________________________________________|
  83.  
  84.   EMail:
  85.  
  86.         DO not SEND ANY binaries (or uuencoded) VIA THE
  87.         FOLLOWING EMAIL ADDRESSES, EXCEPT MAYBE small ONES
  88.         VIA t-online.de (smaller or equal 16 KB).
  89.         THANK YOU.
  90.  
  91.            - Fido    Andreas Kleinert 2:2457/350.18
  92.            - Usenet
  93.                      Andreas_Kleinert@superview.ftn.sub.org  (Fido-Gate)
  94.                      Andreas_Kleinert@t-online.de            (T-Online)
  95.                      ARK@COB.wwbnet.de                       (Z-Netz)
  96.  
  97.            - If nothing else works, try one of these public
  98.              Fido-Usenet gateways:
  99.  
  100.                In Germany:
  101.                  Andreas_Kleinert@p18.f350.n2457.z2.fido.sub.org
  102.  
  103.                From USA or elsewhere:
  104.                  Andreas_Kleinert@p18.f350.n2457.z2.fidonet.org
  105.  
  106.         Please note, that the "superview.ftn.sub.org"
  107.         domain will perhaps be renamed in late 1996.
  108.  
  109.  
  110.  History:
  111.  
  112.  V43.4 (3.1.97) :   - fixed PRI entry in resident part
  113.                     - slightly changed SCOPTIONS
  114.                     - fixed some style things (APTR and library casts)
  115.                     - fixed a bug: bitmap would not have been freed
  116.                       on temporary-buffer allocation error
  117.                     - added note about library opening to L_OpenLibs()
  118.  
  119.  V43.3 (30.11.96) : - added SAS/C specific Ctrl-C disabling code
  120.                     - made some workarounds compiler sensitive
  121.                     - redone all with SAS/C V6.57
  122.  
  123.  V43.2 (3.11.96)  : - there was a FreeBitMap() call missing (oops)
  124.                     - it's samplePNM.dt, not samplePNG.dt ;-)
  125.  
  126.  V43.1 (25.10.96) : - added picture datatype V43 support
  127.                     - thus added support for 24 Bit PPM (P6),
  128.                       since PGM only has 256 grayscales
  129.                     - thus renamed to samplePNM.datatype
  130.  
  131.  V40.3 (13.9.96)  : - fixed more "style" things
  132.  
  133.  V40.2 (5.9.96)   : - fixed some "style" things
  134.  
  135.  V40.1 (2.9.96)   : - first release
  136.  
  137.  ---
  138.  All mentioned trademarks are subjects to their owners.
  139.